home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1993 July / Internet Tools.iso / RockRidge / mail / metamail / contrib / mms / README.MMS < prev    next >
Encoding:
Internet Message Format  |  1993-05-19  |  5.3 KB
  1. Subject: mms: metamail server
  2. Date: Sat May 15 16:36:15 JST 1993
  3. From: Yutaka Sato <ysato@etl.go.jp>
  4. Organization: Electrotechnical Laboratory, Tsukuba Science City, Japan
  5.  
  6. =====================================================================
  7.  
  8.                          MMS-0.6.4
  9.  
  10. ---------------------------------------------------------------------
  11. 1. WHAT IS MMS ?
  12. ---------------------------------------------------------------------
  13.  
  14.     MMS is the metamail server which serves Metamail functions via
  15. inter-process communication.  MMS make it easy to integrate Metamail
  16. functions into a "user agent" which is implemented in an arbitrary
  17. language.
  18.  
  19.    Current MMS is an experimental prototype. External specification
  20. of MMS will be changed frequently as long as the version number stays
  21. zero.
  22.  
  23.    This version MMS-0.6.4 is almost the same with MMS-0.6 except a
  24. little modification added to live in the metamail-2.5 environment.
  25.  
  26. ---------------------------------------------------------------------
  27. 2. MMS PROTOCOL
  28. ---------------------------------------------------------------------
  29.  
  30. 2.1 COMMANDS
  31.  
  32.    Commands consist of a command word, which in some cases may be
  33.    followed by a argument string.
  34.  
  35.        command [argment_string]
  36.  
  37.    Command ward is not case sensitive.
  38.  
  39. 2.2 RESPONSES
  40.  
  41.    Responses consist of a status response, which in some case may be
  42.    followed by response body.
  43.  
  44. 2.2.1 STATUS RESPONSE
  45.  
  46.    A status message is constracted as follows:
  47.  
  48.        ABC D message
  49.  
  50.    where
  51.  
  52.     A class {1:Informative, 2:Ok, 3:Send-the-rest, 4:Error, 5:Serious}
  53.     B category {9:MMS status}
  54.     C identification
  55.     D response body {0:Non, N:Non encoded response body,
  56.                             B:Base64 coded response body follows}
  57.  
  58. 2.2.2 RESPONSE BODY
  59.  
  60.    Response body terminates with "." i.e. a line including only a dot
  61.    character.  A line ".." means "."
  62.  
  63. ---------------------------------------------------------------------
  64. 3. HOW TO MAKE AND TEST MMS
  65. ---------------------------------------------------------------------
  66.  
  67. You need Metamail version 2.5 which is at the directory $METAMAIL/mm2.5.
  68. To make mms, do as follows:
  69.  
  70.   (1) cd $METAMAIL/contrib2.5/mms
  71.   (2) make
  72.  
  73. When mms is made, it can be tested with mmstest.sh:
  74.  
  75.   (3) mmstest.sh
  76.       metamail /tmp/mms.mime.$USER
  77.   (4) mms -server < test.mms
  78.       metamail mms.out
  79.  
  80. The content of this file may be helpful to understand how to use mms.
  81.  
  82.   (5) mms -viewer MIME_FILE                 ## simple viewer
  83.       mms -viewer /tmp/mms.mime.$USER
  84.   (6) mms -transl -sh < MIME_FILE > x.sh    ## simple translator
  85.       sh x.sh
  86.  
  87. ---------------------------------------------------------------------
  88. 4. USING MMS VIA INTERNET PROTOCOL
  89. ---------------------------------------------------------------------
  90.  
  91. 4.1 SERVER INSTALLATION
  92.     (1) service port
  93.          /etc/services
  94.            mms   2202/tcp      # metamail server
  95.          % cd /etc/yp; make services
  96.     (2) inetd
  97.          /etc/inetd.conf
  98.            mms   stream  tcp  nowait  root /usr/local/bin/mms  mms -server
  99.          % kill -HUP PID_OF(inetd)
  100.  
  101. 4.2 AUTHENTICATION
  102.   Client must know followings:
  103.     (1) USER name on the server HOST
  104.     (2) PASSWD_FILE name on the HOST which records the encrypted password
  105.                                 and is readable only for the USER
  106.     (3) PASSWORD
  107.   Client must send "user" command to be executable all MMS commands.
  108.  
  109. 4.3 ADDING NEW USER
  110.   The procedure to add a new user is as follows:
  111.     (1) On the HOST, create a PASSWD_FILE which is readable only for the USER.
  112.     (2) get crypted PASSWORD as follows:
  113.           % telnet HOST mms
  114.           user USER PASSWD_FILE PASSWORD
  115.           591 0 incorrect passwd PASSWORD (CRYPTED-PASSWORD)
  116.           QUIT
  117.     (3) write the CRYPTED-PASSWORD into PASSWD_FILE.
  118.  
  119. 4.4 AUTOMATIC AUTHENTICATION
  120.   To do automatic authentication in mms client library,
  121.      store CRYPTED-PASSWORD in ServerHost:$HOME/".mmspasswd", and
  122.      store PASSWORD in ClientHost:$HOME/".mmsprofile".
  123.  
  124. 4.5 TESTING
  125.   Do as follows:
  126.     % telnet ServerHost mms
  127.     HELP
  128.     QUIT
  129.  
  130.    (You need setting up described in 4.4 to proceed)
  131.     % mms -host AudioHost "show audio/basic" AudioFile
  132.     % setenv MMSERVER ServerHost
  133.     % mmstest.sh
  134.  
  135. ---------------------------------------------------------------------
  136. 5. MANIFEST
  137. ---------------------------------------------------------------------
  138.  
  139.    README.MMS        this file
  140.    Makefile          makefile for MMS
  141.  
  142.    mms.c             MMS main
  143.    mmsserver.c       MMS server
  144.    mmsclient.c       Client library
  145.    mmsparser.c       MIME parser
  146.    mmssynthe.c       MIME synthesizer
  147.    mmsviewer.c       MIME viewer based on mmsparser
  148.    mmstransl.c       MIME translator
  149.    mmsauth.c         Authentication
  150.  
  151.    mmstest.sh        MMS test written in shell script
  152.    test.mms          MMS test in MMS commands
  153.    mms.el            MMS interface written in Emacs/Lisp
  154.  
  155.    news/             patches to make nntpd translate MIME header
  156.    lib/              library
  157.  
  158. ---------------------------------------------------------------------
  159. 6. LATEST VERSION OF MMS
  160. ---------------------------------------------------------------------
  161.  
  162. The latest VERSION of mms is available via FTP from:
  163.  
  164.    HOST: etlport.etl.go.jp [192.31.197.99]
  165.    FILE: pub/mime/mms.VERSION.tar.Z
  166.  
  167. --
  168. Yutaka Sato <ysato@etl.go.jp>
  169. Information Base Section
  170. ELECTROTECHNICAL LABORATORY
  171. 1-1-4 Umezono, Tsukuba, Ibaraki, 305 Japan
  172.